home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / program / 569 / c_libs1a / c_libsa1.txt < prev    next >
Text File  |  1992-04-30  |  5KB  |  123 lines
  1.                 C UTILITY LIBRARY A - VERSION 1
  2.                 -------------------------------
  3.  
  4. After receiving suggestions from several people that I should 
  5. publish some generic C functions of mine I was glad to oblige. I 
  6. think the Atari line is a wonderful line of computers whose day 
  7. is just beginning to dawn as professional level applications 
  8. appear that deal with every monitor configuration and TOS version
  9. correctly. I admit I'm rather a novice at C programming and only 
  10. lately have I felt I really had a grasp of it. But now, as I don't 
  11. have to concentrate too much on the fundamentals, I wised up and 
  12. started building custom librarys with fun little utility 
  13. functions.
  14.  
  15. Library A, as I am now calling it, contains two functions both 
  16. designed to extend the useability of the AES, namely, 
  17. form_ncenter(), and form_nalert().
  18.  
  19. form_ncenter() is essentially the same as form_center except that 
  20. upon entry the GRECT * contains the rectangle upon which the 
  21. object is centered. Basically this is useful if you wish to 
  22. center an object over a window or another object.
  23.  
  24. form_nalert() is an extension of form_alert. I added many options 
  25. which would add to the usefulness of this function. A custom 
  26. 32x32 bitmap may be passed or the standard three may be 
  27. referenced. The input string is compatible with form_alert(). A 
  28. GRECT may be passed to cause form_ncenter() to be called or NULL 
  29. may be passed to force form_center.
  30.  
  31. CONTENTS OF ARCHIVE
  32. -------------------
  33. CLIBS_A1.TXT - This document.
  34.  
  35.     ALERT.C  - This is the C source to form_nalert() and form_ncenter().
  36.                It also contains two static functions ObjcExtent and
  37.                init().
  38.     
  39.     ALERT.H  - Required by above file.
  40.  
  41.   NEWALERT.H - This contains function declarations and useful 
  42.                defines you'll need to attach to your source.
  43.  
  44.       DEMO.C - This is the source to a simple demo program demonstrating
  45.                form_nalert() and form_ncenter().
  46.  
  47.     DEMO.PRG - This is a demo of the form_nalert() and 
  48.                form_ncenter().
  49.             
  50.     DEMO.RSC - We all know what this is for...
  51.  
  52. C BINDINGS
  53. ----------
  54.  
  55. Procedure Name:   ret = form_nalert(rect,def,inp,nimg)
  56.  
  57. Input Data Types:   GRECT *rect;
  58.                     short def;
  59.                     char *inp;
  60.                     short nimg[64];
  61.  
  62.           Return:   ret = exit button ( 1, 2, or 3), <0 = error.
  63.  
  64.            Usage:   rect = NULL for form_center() otherwise 
  65.                            rectangle to center upon.
  66.  
  67.                     def = default exit button (same as 
  68.                           form_alert() ).
  69.  
  70.                     inp = character input string (same as 
  71.                           form_alert() except a value of 4 for 
  72.                           the icon specifies custom.) Buttons 
  73.                           have a maximum length of 10, text
  74.                           lines, 30.
  75.  
  76.                     nimg = 32x32 icon data or NULL if icon value 
  77.                            is 0-3.
  78.   
  79. ---------------------
  80.  
  81. Procedure Name:  form_ncenter(tree,rect)
  82.  
  83.     Data Types:  OBJECT *tree;
  84.                  GRECT *rect;
  85.  
  86.         Return:  Places clip rectangle for objc_draw() in rect.
  87.  
  88.          Input:  tree = pointer to object tree.
  89.  
  90.                  rect = rectangle to center around.
  91.  
  92. ---------------------
  93.  
  94. LICENSE
  95. -------
  96. Software Development Systems will allow you to incorporate this code
  97. into your own programs without fee. You may not, however, modify or
  98. redistribute this code in any manner except in its original form and
  99. completely intact. Usage of these routines in your programs does not
  100. constitute endorsement or connection of Software Development Systems
  101. to your company/self.
  102.  
  103. DISCLAIMER
  104. ----------
  105. Please understand, these procedures are by no means well tested. 
  106. Neither Software Development Systems nor Scott Sanders will be held
  107. liable for any damages either incidental or consequential resulting
  108. from the use of these programs. If you use these procedures in your
  109. own programs, use them with care and test them yourself carefully.
  110.  
  111. If you have any comments or bug reports contact me at:
  112.  
  113.                        Scott Sanders
  114.                        Software Development Systems
  115.                        996 Redondo Ave. #404
  116.                        Long Beach, CA 90804
  117.                        GENIE: S.SANDERS2
  118.  
  119. THE FUTURE
  120. ----------
  121. If I get enough requests I will also release librarys with some of my
  122. favorite custom APPLBLK's and a Popup menu routine (like XCONTROL).
  123.